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Foreword 



id , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

x the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



rd , 



The present document is part of a TS-family covering the 3 Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

TS 32.331 "Notification Log (NL) Integration Reference Point (IRP): Requirements". 

TS 32.332 "Notification Log (NL) (NL) Integration Reference Point (IRP): Information Service (IS)". 

TS 32.333 "Notification Log (NL) Integration Reference Point (IRP): Common Object Request Broker 

Architecture (CORBA) Solution Set (SS)". 

TS 32.334 "Notification Log (NL) Integration Reference Point (IRP): Common Management Information 

Protocol (CMIP) Solution Set (SS)". 

TS 32.335 "Notification Log (NL) Integration Reference Point (IRP): extensible Markup Language (XML) 

solution definitions". 

The present document is part of a TS-family, which describes the requirements and information model necessary for 
Telecommunications Management ™. The TM principles and TM architecture are specified in 3GPP TS 32.101 [1] and 
3GPPTS 32.102 [2]. 

A communications system is composed of a multitude of Network Elements (NE) of various types and, typically, 
different vendors, which inter-operate in a co-ordinated manner in order to satisfy the network users' communication 
requirements. 

The occurrence of faults in an NE may cause deterioration or loss of this NE's function. Fault Management is the 
functional area, which allows the operator to detect the occurrence of faults in the network in real-time. Configuration 
Management and Performance Management are two more functional areas, which require the operator to be alerted to 
certain conditions in the network. 

A standard general-purpose mechanism for the management of logs containing selected notifications from the network 
is required to provide an ability to perform historical analysis on faults and conditions, which occurred in the network. 
The TS 32.33x-series, constituting the Notification log IRP, sets forth such a mechanism - and the present document 
contains the IS definition. 
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Scope 



The present document specifies the Information Service for the Notification Log Integration Reference Point (NL IRP) 
as it applies to Itf-N. 

This IRP IS defines the semantics of operations (and their parameters) visible across the Itf-N in a protocol and 
technology neutral way. It does not define the syntax or encoding of the operations and their parameters. 



References 



The following documents contain provisions, which through reference in this text constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements". 

[2] 3GPP TS 32.102: "Telecommunication management; Architecture". 

[3] 3GPP TS 32.302: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP) : Information Service (IS)". 

[4] 3GPP TS 32.622: "Telecommunication management; Configuration Management (CM); Generic 

network resources Integration Reference Point (IRP): Network Resource Model (NRM)". 

[5] 3GPP TS 32.1 1 1-2: "Telecommunication management; Fault Management; Alarm Integration 

Reference Point (IRP): Information Service (IS)". 

[6] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management: Information Service (IS)". 

[7] 3GPP TS 32.331: "Telecommunication management; Notification Log Integration Reference Point 

(IRP): Requirements". 

[8] 3GPP TS 32.342 "Telecommunication management; File Transfer (FT) Integration Reference 

Point (IRP): Information Service (IS)". 

[9] 3GPP TS 32.150: "Telecommunication management; Integration Reference Point (IRP) Concept 

and definitions". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in 3GPP TS 32.101 [1], 3GPP TS 32.102 [2], 
3GPP TS 32.1 1 1-2 [5] and 3GPP TS 32.331 [7] apply. 

notification category: it refers to the set of notifications of one 3GPP IRP Information Service specification 

A Notification Category is identified by the name of the IRP specification and the IRP specification version number. 
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3.2 



Abbreviations 



For the purposes of the present document, the following abbreviations apply: 



DN 

EM 

FT 

IOC 

IRP 

M 

NE 

NL 

NM 

O 

TS 

UML 



Distinguished Name 
Element Manager 
File Transfer 
Information Object Class 
Integration Reference Point 
Mandatory 
Network Element 
Notification Log 
Network Manager 
Optional 

Technical Specification 
Unified Modelling Language 



System overview 



The general definition of the System Context for the present IRP is found in 3GPP TS 32.150 [9] subclause 4.7. 
In addition, the set of related IRP(s) relevant to the present IRP is shown in the two diagrams below 
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Figure 4.1 : System Context A 
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Figure 4.2: System Context B 



ETSI 



3GPP TS 32.332 version 6.1.0 Release 6 



ETSI TS 132 332 V6.1 .0 (2005-06) 



4.2 Compliance rules 



For general definitions of compliance rules related to qualifiers (Mandatory/Optional/Conditional) for operations, 
notifications and parameters (of operations and notifications) please refer to 3GPP TS 32.102 [2], 



5 Information Object Classes 

5.1 Information entities imported and local labels 



Label reference 


Local label 


3GPP TS 32.622 [4], information object class, Top 


Top 


3GPP TS 32.312 [6], information object class, ManagedGenericIRP 


ManagedGenericIRP 


3GPP TS 32.342 [8], information object class, FileTransferIRP 


FileTransferIRP 


3GPP TS 32.302 [3], information object class, NotificationIRP 


NotificationIRP 


3GPP TS 32.302 [3], information object class, NotificationlRPNotification 


NotificationlRPNotification 



5.2 Class diagram 

5.2.1 Attributes and relationships 

This subclause introduces the set of Information Object Classes (IOCs) that encapsulate information within the 
IRP Agent. The intent is to identify the information required for NL IRP operations and notification. This subclause 
provides the overview of all support object classes in UML. Subsequent subclauses provide more detailed specification 
of various aspects of these support object classes. 
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«lnformationObjectClass» 
NLIRP 

maxLogs 



«names» 



i 



0.. 



«lnformationObjectClass» 
Log 



+ logSubscriptionld 

+ loggingEndTime 

+ maxSize 

+ currentSize 

+ creationTime 

+ logState 

+ logRecordCount 

+ notificationCategories 

+ filter 

+ logFullAction 

+ occupancyLevels 

% logManagerToken 

logf 1 

relation -log-logRecord 
+logRecordt 0..* 



«lnformationObjectClass» 
Log Record 



logRecordld 
logRecordContent 



relation-logRecord-notification 

O 

1 

logRecord +notification 



1 



NotificationlRPNotification 

(from TS32.302) 



■ notificationld 
■eventTime 

■ system DN 

■ notificationType 



Figure 5.1 : Information Object Class UML Diagram 

To change: change logid, add logrecordcontent, remove logrecordsource. 
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5.2.2 Inheritance 



ManagedGenericIRP 
(from TS32.312) 



«lnformationObjectClass» 
NLIRP 



+ maxLogs 



«lnformationObjectClass» 

Top 

(from TS32.622) 

+ objectClass 
+ objectlnstance 



«lnformationObjectClass» 
Log 

+ logSubscriptionld 

+ loggingEndTime 

+ maxSize 

+ currentSize 

+ creationTime 

+ logState 

+ logRecordCount 

+ notificationCategories 

+ filter 

+ logFullAction 

+ occupancyLevels 

% logManagerToken 



«lnformationObjectClass» 
Log Record 

+ logRecordld 

+ logRecordContent 



Figure 5.2: Information Object Class Inheritance UML Diagram 

5.3 Information Object Class definitions 

5.3.1 NLIRP 



5.3.1.1 



Definition 



LogIRP is the representation of the notification log management capabilities specified by the present document. This 
IOC inherits from ManagedGenericIRP IOC specified in 3GPP TS 32.312 [6]. 



5.3.1.2 



Attributes 



Attribute name 


Visibility 


Support 
Qualifier 


Read 
Qualifier 


Write 
Qualifier 


maxLogs 


+ 





M 


- 
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5.3.2 Log 



5.3.2.1 Definition 

The Log IOC is the representation of a Notification Log. 



5.3.2.2 



Attributes 



Attribute name 


Visibility 


Support 
Qualifier 


Read 
Qualifier 


Write 
Qualifier 


logSubscriptionld 


+ 


M 


M 


- 


loggingEndTime 


+ 





M 


- 


logManager Token 


% 





- 


- 


maxSize 


+ 





M 


- 


currentSize 


+ 





M 


- 


creationTime 


+ 





M 


- 


logState 


+ 


M 


M 


- 


logRecordCount 


+ 





M 


- 


notificationCategories 


+ 





M 


- 


filter 


+ 





M 


- 


logFullAction 


+ 


M 


M 


- 


occupancy Levels 


+ 


M 


M 


- 



5.3.2.3 



State diagram 



occupancyLevel Changed 



v t 



startLog 



-> 



log Wrapping 



stopLog |j logLifeTimeExpired 



logFul l[ logFul IAction==wrap ] 



logging stopLog || logLifeTimeExpired 



-> 



logFul l[ logFullAction==halt ] 



JL 



logNotFull / notifyLoggingResumed() 



logHalted 



stopLog j| logLifeTimeExpired 



\' 



stopped 



A 



Figure 5.3: State Diagram for Notification Log 

The disposition of a log that has been stopped, that is, whether the log remains visible across the Itf-N, is left as vendor 
specific functionality. The time of the deletion of logs is vendor specific. 

5.3.3 LogRecord 
5.3.3.1 Definition 

The LogRecord IOC is the representation of an individual Notification Log Record. 
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5.3.3.2 



Attributes 



Attribute name 


Visibility 


Support 
Qualifier 


Read 
Qualifier 


Write 
Qualifier 


logRecordld 


+ 


M 


M 


- 


LogRecordContent 


+ 





M 


- 



5.4 Information relationship definitions 

5.4.1 Relation-nLIRP-log (M) 

5.4.1.1 Definition 

This represents the relationship between NLIRP and the Log. 



5.4.1.2 



Role 



Name 


Definition 


nLIRP 


It represents the nlirp. 


log 


It represents the Log. 



5.4.1.3 



Constraint 



Name 


Definition 


uniqueLogSubscriptionld 


The log subscription id must be unique amongst all logs managed by a given NL IRP 
instance. 


uniqueLogManagerToken 


The log manager token must be unique amongst all managers and logs utilizing logging 
services from a given NL IRP instance. 



5.4.2 Relation-log-logRecord (M) 
5.4.2.1 Definition 

This represents the relationship between Log and the LogRecord. 



5.4.2.2 



Role 



Name 


Definition 


log 


It represents the Log. 


logRecord 


It represents the LogRecord. 



5.4.2.3 



Constraint 



Name 


Definition 


uniqueLogRecordld 


The log record id must be unique amongst all logs records within a given log. 



5.4.3 Relation-logRecord-notificationlRPNotification (M) 
5.4.3.1 Definition 

This represents the relationship between LogRecord and the notification header represented by 

Not if icationlRPNotif i cat ion. 
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5.4.3.2 Role 



Name 


Definition 


logRecord 


It represents the LogRecord. 


notification 


It represents the Notif icationlRPNotif ication. 



5.4.3.3 Constraint 



Name 


Definition 


logRecordldRelatesNotificationld 


Within a given log, there is a one-to-one relationship between Notification Id and Log 
Id (as each notification can only be recorded once). 
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5.5 



Information attribute definition 



5.5.1 Definition and legal values 



Attribute Name 


Definition 


Legal Values 


creationTime 


The time when the log is created. 


YYYYMMDDhhmmss 


currentSize 


This attribute provides the number of bytes currently 
utilized by a given log. When taken in conjunction with 
maxSize, the amount of space remaining in the log can 
be determined. 


Either: 

• zero 

• a positive whole number, 


filter 


It specifies a filter constraint that IRPAgent shall use to 

filter notification of the category specified in 

not if icationCategories parameter. 

Support of time based filter is mandatory. Support of 

other filter constraints is optional. 


Filter constraint grammar is SS dependent 


logFullAction 


Indicate the action that will be taken by this instance of 

NLIRP when the 

Log. maxSize has been reached. 


An ENUM that can have one of the 
following values: 

• wrap: The oldest LogRecord(s) in the 
Log, based on the log time, will be deleted 
to free resources for the logging of new 
LogRecord(s). 

• halt: No more LogRecord(s) will be 
logged and all incoming events are 
discarded. LogRecord/s already in the 
Log will be retained. 


loggingEndTime 


Defines the date and time when the log stops logging. 


If log is created by IRPManager: 
1 value provided by the IRP 
Manager - the IRP Agent may 
reject the value provided by the 
IRP Manager in case this value 
is excessive 
i in case no value is provided by 
the IRP Manager then this value 
is set by the IRP Agent. 

If log is created by IRPAgent: 

* value indicates date and time or 
1 value is expressed as 
'indefinite'. 


logManagerToken 


This attribute contains the token of a manager utilizing 
logging services from a given NL IRP instance, 
assigned by the IRPAgent. 


The value of this attribute must be unique 
amongst all managers and logs utilizing 
logging services from the given NL IRP 
instance. 


logRecordContent 


The notification information of a log record, excluding 
the notification header information. 


The content format varies depending on 
the type of the notification. 


logRecordCount 


The number of log records currently logged within a 
given log. 


positive whole number, including zero 


logRecordld 


This attribute contains the id of a log record within a 
given log, assigned by the IRPAgent. 


The value of this attribute must be unique 
amongst all log record contained by a 
given log. 


logState 


Provides an indication of the current state of a specific 
log 


An ENUM that can have one of the 
following values: 

• logging 

• logFull 

• stopped 


logSubscriptionld 


This attribute contains the id of a log subscription within 
a given NL IRP instance, assigned by the IRPAgent. 


The value of this attribute must be unique 
amongst all log subscriptions managed by 
a given NL IRP instance. 


maxLogs 


Defines the maximum number of logs that can be 
supported by a given Notification Log IRP, assigned by 
the IRPAgent. 


Non-zero, positive whole number 


maxSize 


This attribute defines the maximum number of bytes 
that may be utilized by a given log, assigned by the 
IRPAgent. 


Either: 

• Non-zero, positive whole number 

• Zero indicates no limit on the number 
of records is set by the IRPAgent (log 
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Attribute Name 


Definition 


Legal Values 






full handling will provide limitation 
information) 


notificationCategories 


Specifies the notification categories that can be 
recorded within a given log - SET OF (name of IRP, 
version of IRP) 


It identifies one or more Notification 
Category (see also Definition in 
subclause 3.1) 


occupancyLevels 


Case Log.logFullAction == "halt" and Log.maxSize is 
non-zero: 

i- this attribute contains a list of 3 values fixed 
(determined by the IRPAgent and never 
changed) of percentage, of Log.maxLog 
J- the NLIRP will generate 

notifyOccupancyLevel to alert IRPManagers 
about the Log capacity currently used. 

Case Log.logFullAction == "wrap": 

1 this attribute contains 1 value fixed 
(determined by the IRPAgent and never 
changed) of percentage of Log.maxLog 
. the NLIRP will generate 

notifyOccupancyLevel to alert IRPManagers 
that the specified percentage of the capacity 
has been written to the wrapping Log. 


Case of "halt": a set of 3 values. 
Case of "wrap": 1 value. 



5.5.2 Constraints 



Name 


Definition 


inv lastModifiedTime 


Time indicated shall be greater than or equal to creationTime. 


inv logRecordCount 


Number indicated shall be less than or equal to maxSize 
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Interface definition 



6.1 Class diagram 



«lnterface» 
NLIRPOperationsJ 



NI_IRPOperations_1 shall support either t\ 
operation exportLogRecords or operation 
getLogRecords as mandatory. 



+ subscribeLog() 
+ unsubxribeLogO 
«optional» + exportLogRecords() 
«optional» + getLogRecordsQ 



«lnterface» 
NLIRPOperations_2 



A 



+ getLogSubscriptionlds() 
+ getLogSubxriptionStatusQ 



A 
«may realize» 



«lnformationObjectClass» 
NLIRP 
+ maxLogs 



> 



«Notification» 
NLIRPNotifications 1 



+ notifyLogSubxribed() 
+ notifyLogllnsubxribedQ 



«may use» 



«agent-internal-usage» 



JL 



«agent-interna 



«Notification» 
NLIRPNotifications 2 



usage» 



+ notifyOccupancyLevelCrossedO 
«optional» + notifiyLoggingResumed() 



FileTransferIRP 
(from TS32.342) 



«agent-internal-usage» 



\L 



«lnformationObjectClass» 
NotificationIRP 
(from TS32.302) 



Figure 6.1 Class diagram 

Note: NLIRPOperations_l shall support either operation exportLogRecords or operation getLogRecords as mandatory. 

6.2 Generic rules 

Rule 1: Each operation with at least one input parameter supports a pre-condition valid_input_parameter which 
indicates that all input parameters shall be valid with regards to their information type. Additionally, each 
such operation supports an exception operation_failed_invalid_input_parameter which is raised when pre- 
condition valid_input_parameter is false. The exception has the same entry and exit state. 

Rule 2: Each operation with at least one optional input parameter supports a set of pre-conditions 

supported_optional_input_parameter_xxx where "xxx" is the name of the optional input parameter and 
the pre-condition indicates that the operation supports the named optional input parameter. Additionally, 
each such operation supports an exception operation_failed_unsupported_optional_input_parameter_xxx 
which is raised when (a) the pre-condition supported_optional_input_parameter_xxx is false and (b) the 
named optional input parameter is carrying information. The exception has the same entry and exit state. 
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Rule 3: Each operation shall support a generic exception operation_failed_internal_problem which is raised when 
an internal problem occurs and that the operation cannot be completed. The exception has the same entry 
and exit state. 



6.3 NLIRPOperations_1 Interface (M) 
6.3.1 Operation subscribeLog (M) 



6.3.1.1 



Definition 



Using this operation, an IRPManager is initiating the logging of notifications. Resulting from this operation an 
IRP Agent shall start logging of notifications and, if necessary, also create an associated log. 



6.3.1.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


logSubscriptionld 


M 


Log. logSubscriptionld 


See subclause 5.5.1 

If empty, then IRPAgent shall create a new log and return the 
logSubscriptionld as output parameter. However not all 
IRPAgents will provide this capability, i.e. IRPManager must 
provide an existing logSubscriptionld. 


loggingEndTime 


O 


Log. loggingEndTime 


See subclause 5.5.1 


notificationCategories 


O 


Log. 
notificationCategories 


See subclause 5.5.1 ; if notificationCategories is absent than 
all notifications are logged 


filter 


O 


Log.ntfFilter 

Filter constraint 
grammar is SS 
dependent 


See subclause 5.5.1 ; if this parameter is absent, then no filter 
constraint shall be applied. 



6.3.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


logSubscriptionld 


M 


Log. logSubscriptionld 


See subclause 5.5.1 

This parameter contains either 

J- the logSubscriptionld of the log created 

resulting from this operation or 
J- the value of the input parameter 
logSubscriptionld. 


logManagerToken 


O 


Log. logManagerToken 


See subclause 5.5.1 

See also comment 6.3.2.2. 

Note: Security Management IRP may provide capabilities 

that make this parameter redundant. 


loggingEndTime 


O 


Log. loggingEndTime 


See subclause 5.5.1 

If supported by the Log IOC (5.3.2) and not already 
provided by the IRP Manager then the output of this 
operation must support this parameter. 


status 


M 


ENUM (OperationSucceeded, 
OperationFailed) 


If loggingEndTime is valid and notificationCategoriesis 
valid or absent, status = OperationSucceeded. 
If operation_failed is true, status = OperationFailed. 
If loggingEndTime excessive, status = OperationFailed. 



6.3.1.4 



Pre-condition 



logsNotMaxed 



Assertion Name 


Definition 


logsNotMaxed 


The number of logs is less than the maximum number of logs allowed. 
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6.3.1.5 



Post-condition 



logStarted 



Assertion Name 



Definition 



logStarted 



A log is started with the specified characteristics (lifetime and notificationCategories). 



6.3.1.6 



Exceptions 



Exception Name 


Definition 


logSubscriptionld_required 


Condition: Pre-condition is true AND post-condition is false. 
Returned Information: The output parameter status. 
Exit state: Entry state. 


maxLogs_reached 


Condition: Pre-condition is true AND post-condition is false. 
Returned Information: The output parameter status. 
Exit state: Entry state. 


operation_failed 


Condition: Pre-condition is true AND post-condition is false. 
Returned Information: The output parameter status. 
Exit state: Entry state. 



6.3.2 Operation unsubscribeLog (M) 



6.3.2.1 



Definition 



Using this operation, the IRPManager that started a specific log is able to stop this log via unsubscribing. Note stopping 
a log implies that the log becomes invisible across Itf-N, independent from the loggingEndTime; therefore the 
IRPManager should retrieve log information of interest before using this unsubscribeLog operation, e.g. through 
the exportLogRecords operation. 

The disposition of a log that has been stopped, that is, whether the log remains visible across the Itf-N, is left as vendor 
specific functionality. The time of the deletion of logs is vendor specific. 

In consideration of a multi-manager environment, the log can only be stopped by the creating IRPManager if this 
IRPManager provided a related token while initiating subscribeLog. 



6.3.2.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


logSubscriptionld 


M 


Log. logSubscriptionld 


See subclause 5.5.1 


logManagerToken 


O 


Log. logManagerToken 


See subclause 5.5.1 

If subscribeLog returned a logManagerToken for a log with 

logSubscriptionld='X', then logManagerToken must be provided as 

input parameter of this operation to successfully stop log with 

logSubscriptionld='X'. 

If subscribeLogdid not return a logManagerToken for a log with 
logSubscriptionld='X', then logManagerToken must contain NULL 
value to successfully stop log with logSubscriptionld='X'. 



6.3.2.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUM (OperationSucceeded, 
OperationFailed) 


If logSubscriptionld is valid and logManagerToken (if 
supported) is matching, status = OperationSucceeded. 
If operationjailed is true, status = OperationFailed. 



ETSI 



3GPP TS 32.332 version 6.1.0 Release 6 



20 



ETSI TS 132 332 V6.1 .0 (2005-06) 



6.3.2.4 Pre-condition 

There are no pre-conditions, other than those established by the generic rules (see subclause 6.2). 

6.3.2.5 Post-condition 

logStopped 



Assertion Name 


Definition 


logStopped 


The specified log is stopped. 



6.3.2.6 



Exceptions 



Exception Name 


Definition 


operation_failed 


Condition: Pre-condition is true AND post-condition is false. 
Returned Information: The output parameter status. 
Exit state: Entry state. 



6.3.3 Operation exportLogRecords (O) 

Support for this operations is mandatory if getLogRecords is not supported. 



6.3.3.1 



Definition 



Using this operation, an IRPManager can initiate export of all or part of a log into a file. This file than is being 
transferred to the IRPManager using the File Transfer IRP (note also that the FT IRP is providing the file location to the 
IRP Manger). 



6.3.3.2 



Input parameters 



Parameter Name 


Quali 
fier 


Information type 


Comment 


logSubscriptionld 


M 


Log. logSubscriptionld 


See subclause 5.5.1 


notificationCategories 


O 


Log. notificationCategories 


See subclause 5.5.1 


filter 


O 


Log.filterLog.filter 


See subclause 5.5.1 



6.3.3.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUM (OperationSucceeded, 
NoMatchingLogRecordFound, 
OperationFailed) 


If input parameters are valid and operation was 

successful, status = OperationSucceeded. 

If input parameters are valid and operation was 

successful but no matching log records are found, 

status = NoMatchingLogRecordFound. 

If operationjailed is true, status = OperationFailed. 
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6.3.3.4 Pre-condition 

There are no pre-conditions, other than those established by the generic rules (see subclause 6.2). 

6.3.3.5 Post-condition 

logRecordsExported 



Assertion Name 


Definition 


log Records Exported 


The specified log records have been exported as requested. In case the log is empty or in 
case that all the log records do not satisfy the criteria of input parameters 
notificationCategories and filter, this post-condition is true. 



6.3.3.6 



Exceptions 



Exception Name 


Definition 


exportFailed 


The IRPAgent was unable to export the specified records. 


operation_failed 


Condition: Pre-condition is true AND post-condition is false. 
Returned Information: The output parameter status. 
Exit state: Entry state. 



6.3.4 Operation getLog Records (O) 

Support for this operations is mandatory if exportLogRecords is not supported. 

6.3.4.1 Definition 

Using this operation, an IRPManager can retrieve one or more log records from a certain log. 

Note that this operation might be preferred for retrieval of small amounts of log records, while operation 
exportLogRecords might be preferred for retrieval of medium to large amounts of log records, as providing a more 
efficient bulk transfer mechanism. 



6.3.4.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


logSubscriptionld 


M 


Log. logSubscriptionld 


See subclause 5.5.1 


notificationCategories 


O 


Log. notificationCategories 


See subclause 5.5.1 


filter 


O 


Log.fi Iter 


See subclause 5.5.1 



6.3.4.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


getLogRecordsResult 


M 


List of logRecord's 


List of logRecords; each entry of the list holds all 
supported attributes of IOC LogRecord (see 5.3.3.2). 


Status 


M 


ENUM (OperationSucceeded, 
OperationFailed) 


If logSubscriptionld is valid and (logRecordldList is 

empty or logRecordldList contains valid Id's), status = 

OperationSucceeded. 

If operationjailed is true, status = OperationFailed. 
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6.3.4.4 Pre-condition 

There are no pre-conditions, other than those established by the generic rules (see subclause 6.2). 

6.3.4.5 Post-condition 

logRe cords Retrieved 



Assertion Name 


Definition 


log Records Retrieved 


The specified log records have been retrieved as requested. If the log is empty or all the log 
records do not satisfy the criteria of input parameters notificationCategories and filter, this 
post-condition is true. 



6.3.4.6 



Exceptions 



Exception Name 


Definition 


operation_failed 


Condition: Pre-condition is true AND post-condition is false. 
Returned Information: The output parameter status. 
Exit state: Entry state. 



6.4 NLIRPOperations_2 Interface (O) 

6.4.1 Operation getLogSubscriptionlds (M) 

6.4.1.1 Definition 

Using this operation, an IRPManager can query the NL IRP for all available log subscriptions. 

6.4.1 .2 Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


- 


- 


- 


- 



6.4.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


logSubscriptionlds 


M 


List of logSubscriptionld's 


See subclause 5.5.1 & 6.4.1 .2 
Note: empty list is a valid value 


status 


M 


ENUM (OperationSucceeded, 
OperationFailed) 


If operation is successful, status = 

OperationSucceeded. 

If operation_failed is true, status = 

OperationFailed. 
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6.4.1.4 Pre-condition 

There are no pre-conditions, other than those established by the generic rules (see subclause 6.2). 

6.4.1.5 Post-condition 

There are no post-conditions. Querying of log subscription Id"s does not result in any changes within the IRP Agent. 

6.4.1.6 Exceptions 



Exception Name 


Definition 


operation_failed 


Condition: Pre-condition is true AND post-condition is false. 
Returned Information: The output parameter status. 
Exit state: Entry state. 



6.4.2 Operation getLogSubscriptionStatus (M) 

6.4.2.1 Definition 

Using this operation, an IRPManager can query the NL IRP for available log status information of an individual lo£ 

6.4.2.2 Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


logSubscriptionld 


M 


Log. logSubscriptionld See subclause 5.5.1 



6.4.2.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


logAttributeList 


M 


Attribute list of related Log IOC 


List of all supported attributes of IOC Log (see 
subclause 5.3.2.2). 


status 


M 


ENUM (OperationSucceeded, 
OperationFailed) 


If logSubscriptionld is valid status = 

OperationSucceeded. 

If operationjailed is true, status = OperationFailed. 



6.4.2.4 Pre-condition 

There are no pre-conditions, other than those established by the generic rules (see subclause 6.2). 

6.4.2.5 Post-condition 

There are no post-conditions. Querying of log attributes does not result in any changes within the IRP Agent. 

6.4.2.6 Exceptions 



Exception Name 


Definition 


operation_failed 


Condition: Pre-condition is true AND post-condition is false. 
Returned Information: The output parameter status. 
Exit state: Entry state. 
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6.5 NLIRPNotifications_1 Interface (M) 
6.5.1 Notification notifyLogSubscribed (M) 



6.5.1.1 



Definition 



Using this notification, an IRP Agent informs all subscribed IRPManagers that a log subscription has been successfully 
initiated. 



6.5.1.2 



Input Parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


objectClass 


M 




This parameter and objectlnstance together carry the 
semantics of the DN of Log. Notification header - see 3GPP 
TS 32.302 [3] 


objectlnstance 


M 




This parameter and objectClass together carry the semantics 
of the DN of Log. Notification header - see 3GPP TS 
32.302 [3] 


notificationld 


M 


-- 


Notification header - see 3GPP TS 32.302 [3] 


eventTime 


M 


- 


Notification header - see 3GPP TS 32.302 [3] 


notificationType 


M 


"notifyLogSubscribed" 


Notification header - see 3GPP TS 32.302 [3] 


system DN 


C 


IRPAgent . systemDN. 


It carries the DN of the irp Agent that emits this notification. 
Notification header - see 3GPP TS 32.302 [3] 


logSubscriptionld 


M,N 


Log. logSubscriptionld 


See subclause 5.5.1 


loggingEndTime 


0,N 


Log. loggingEndTime 


See subclause 5.5.1 


notificationCategories 


0,N 


Log. notificationCategories 


See subclause 5.5.1 ; if absent than all notifications are being 
logged 


filter 


0,N 


Log.fi Iter 


See subclause 5.5.1 



6.5.1.3 Triggering Event 

6.5.1.3.1 From-state 

subscribeLog 



Assertion Name 



Definition 



subscribeLog 



An IRPManager requests that a new log be started. 



6.5.1.3.2 

logStarted 



To-state 



Assertion Name 



Definition 



logStarted 



The NL IRP has started the requested logging activity. 



6.5.2 Notification notifylogUnsubscribed (M) 
6.5.2.1 Definition 

Using this notification, an IRPAgent informs all subscribed IRPManager that a log subscription has stopped. 
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6.5.2.2 



Input Parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


objectClass 


M 


~ 


This parameter and objectlnstance together carry the semantics of 
the DN of Log. Notification header - see 3GPP TS 32.302 [3] 


objectlnstance 


M 


~ 


This parameter and objectClass together carry the semantics of the 
DN of Log. Notification header - see 3GPP TS 32.302 [3] 


notificationld 


M 


-- 


Notification header - see 3GPP TS 32.302 [3] 


eventTime 


M 


- 


Notification header - see 3GPP TS 32.302 [3] 


notificationType 


M 


"notifyLogUnsubscribed" 


Notification header - see 3GPP TS 32.302 [3] 


system DN 


C 


IRPAgent . systemDN. 


It carries the DN of the irp Agent that emits this notification. 
Notification header - see 3GPP TS 32.302 [3] 


logSubscriptionld 


M,N 


Log. logSubscriptionld 


See subclause 5.5.1 



6.5.2.3 



Triggering Event 



6.5.2.3.1 



From-state 



unsubscribeLog OR loggingEndTimeReached 



Assertion Name 


Definition 


unsubscribeLog 


The IRPManager that started the log requests that the log be unsubscribed. 


loggingEndTimeReached 


The logging end timespecified for the log in subscribeLog has been reached. 



6.5.2.3.2 

logStopped 



To-state 



Assertion Name 


Definition 


logStopped 


The logging activity has stopped. 



6.6 NLIRPNotifications_2 Interface (O) 
6.6.1 Notification notifyOccupancylevelCrossed (M) 



6.6.1.1 



Definition 



Using this notification, an IRPAgent informs all subscribed IRPManagers about the occupancy level of a certain log 
according with levels defined in 5.5.1 (in addition also the log full action type of this NLIRP instance is being provided 
for context purposes). 
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6.6.1.2 



Input Parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


objectClass 


M 




This parameter and objectlnstance together carry 
the semantics of the DN of Log. Notification 
header - see 3GPP TS 32.302 [3] 


objectlnstance 


M 




This parameter and objectClass together carry the 
semantics of the DN of Log. Notification header - 
see 3GPP TS 32.302 [3] 


notificationld 


M 


-- 


Notification header - see 3GPP TS 32.302 [3] 


eventTime 


M 


- 


Notification header - see 3GPP TS 32.302 [3] 


notificationType 


M 


"notifyOccupancyLevelCrossed" 


Notification header - see 3GPP TS 32.302 [3] 


system DN 


C 


IRPAgent . systemDN. 


It carries the DN of the irp Agent that emits this 
notification. Notification header - see 
3GPP TS 32.302 [3] 


logSubscriptionld 


M,Y 


Log. logSubscriptionld 


See subclause 5.5.1 


currentOccupancyLevel 


M,N 


mod(( Log.currentSize/ 
Log.maxSize)*100) 


See subclause 5.5.1 


logFullAction 


0,N 


Log. logFullAction 


See subclause 5.5.1 



6.6.1.3 



Triggering Event 



6.6.1.3.1 



From-state 



logFull OR occupanceLevelCrossed 



Assertion Name 


Definition 


logFull 


The log is full, that is, the number of log records contained within the log has exceeded the 
maximum number of log records that was established at log startup (log capacity has reached 
100%). 


occupancyLevelCrossed 


The number of log records within the log has crossed one of the threshold boundaries (see 
5.5.1 log.occupancyLevel). 



6.6.1.3.2 



To-state 



logWrapping OR (logHalted OR logging) 



Assertion 
Name 


Definition 


logWrapping 


Applicable for case Log.logFullAction="wrap": The number of log records within the log has exceeded the 
maximum number of allowed log records (100 % capacity has been crossed). The logging of new records 
will cause the oldest records within the log to be deleted and replaced (first in, first out). The deletion of 
records may occur in a block, such that the log transitions back to the 'started' state prior to any new 
records being written. 


logHalted 


Applicable for case Log.logFullAction="halt": The number of log records within the log has exceeded the 
maximum number of allowed log records (100 % capacity has been crossed). The logging of new records 
will be discontinued until the deletion of records has occurred (deletion of records is outside the scope of 
this IRP). 


logging 


Applicable for case Log.logFullAction="half": The number of log records within the log is below the 
maximum number of allowed records. The generation of the notification is done to inform the subscribed 
IRPManagers that the log is filling up. 



6.6.2 Notification notifyLogging Resumed (O) 



6.6.2.1 



Definition 



Using this notification, an IRPAgent informs all subscribed IRPManagers that the amount of data within a given log has 
been reduced, allowing logging to resume continue (according to the information provided when the log was created). 
Note that this notification only applies to Log. logFullAction == "halt". 
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6.6.2.2 



Input Parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


objectClass 


M 


— 


This parameter and objectlnstance together carry the semantics of 
the DN of Log. Notification header - see 3GPP TS 32.302 [3] 


objectlnstance 


M 


— 


This parameter and objectClass together carry the semantics of the 
DN of Log. Notification header - see 3GPP TS 32.302 [3] 


notificationld 


M 


-- 


Notification header - see 3GPP TS 32.302 [3] 


eventTime 


M 


-- 


Notification header - see 3GPP TS 32.302 [3] 


notificationType 


M 


"notifyLoggingResumed" 


Notification header - see 3GPP TS 32.302 [3] 


system DN 


C 


IRP Agent . systemDN. 


It carries the DN of the irp Agent that emits this notification. 
Notification header - see 3GPP TS 32.302 [3] 


logSubscriptionld 


M,Y 


Log. logSubscriptionld 


See subclause 5.5.1 



6.6.2.3 



Triggering Event 



6.6.2.3.1 



From-state 



logFull 



Assertion Name 


Definition 


logHalted 


The log is full, that is, the number of log records contained within the log has exceeded the 
maximum number of log records that was established at log startup (log capacity has reached 
100 % and Log.logFullAction="halt"). 


occupancyLevelCrossed 


The number of log records within the log has crossed one of the threshold boundaries (see 
5.5.1 log.occupancyLevel ). 



6.6.2.3.2 



To-state 



Assertion 
Name 



Definition 



logging 



The number of log records within the log is below the maximum number of allowed records. The 
generation of the notification is done to inform the subscribed IRPManagers that the log is filling up. 
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